@internationalized/message

What is @internationalized/message?

@internationalized/message is a JavaScript library designed to facilitate internationalization (i18n) by providing tools for message formatting. It allows developers to create localized messages with support for pluralization, gender, and other language-specific variations.

What are @internationalized/message's main functionalities?

Basic Message Formatting

This feature allows you to format basic messages with placeholders that can be replaced with dynamic values.

const { MessageFormatter } = require('@internationalized/message');
const formatter = new MessageFormatter('en-US');
const message = formatter.format('Hello, {name}!', { name: 'John' });
console.log(message); // Output: Hello, John!

Pluralization

This feature supports pluralization, allowing messages to change based on the quantity of items.

const { MessageFormatter } = require('@internationalized/message');
const formatter = new MessageFormatter('en-US');
const message = formatter.format('{count, plural, one {# item} other {# items}}', { count: 5 });
console.log(message); // Output: 5 items

Gender-Specific Messages

This feature allows you to create gender-specific messages, which can be useful for languages that have gendered nouns and pronouns.

const { MessageFormatter } = require('@internationalized/message');
const formatter = new MessageFormatter('en-US');
const message = formatter.format('{gender, select, male {He} female {She} other {They}} is a developer.', { gender: 'female' });
console.log(message); // Output: She is a developer.

Other packages similar to @internationalized/message

react-intl

react-intl is a library for internationalizing React applications. It provides components and an API to format dates, numbers, and strings, including pluralization and gender-specific messages. Compared to @internationalized/message, react-intl is more tightly integrated with React and offers a higher-level API for React components.

i18next

i18next is a full-featured internationalization library for JavaScript. It supports interpolation, pluralization, and context-based translations. i18next is more comprehensive and can be used with various frameworks, including React, Angular, and Vue. It offers more features and flexibility compared to @internationalized/message.

messageformat

messageformat is a library for handling both pluralization and gender in messages. It uses ICU MessageFormat syntax, similar to @internationalized/message. However, messageformat is more focused on providing a low-level API for message formatting, making it more suitable for developers who need fine-grained control over their message formatting.

README

@internationalized/message

This package is part of react-spectrum. See the repo for more details.